Saves the userís screen configuration preferences.

OSErr DMSaveScreenPrefs (
    UInt32 reserved1, 
    UInt32 saveFlags, 
    UInt32 reserved2
);

reserved1

Reserved for future expansion. Pass NULL in this parameter.

saveFlags

Reserved for future expansion. Pass NULL in this parameter.

reserved2

Reserved for future expansion. Pass NULL in this parameter.

function result

A result code.

DISCUSSION

Usually when you change screen properties such as pixel depth, the changes will only be temporary and will usually reset after restarting. However, the function DMSaveScreenPrefs makes the current screen properties permanent.

SPECIAL CONSIDERATIONS

Because this function may move or purge memory blocks or access handles, you cannot call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when DisplayLib 2.0 (or later) or DisplayLib68k 2.0 (or later) is installed. Exported by CarbonLib 1.0 and later, DisplayLib 2.0 and later, and by DisplayLib68k 2.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 3/8/2000)